home *** CD-ROM | disk | FTP | other *** search
/ Publisher Platinum / Publisher Platinum.iso / clipart / utils / pixf20 / pixread.me < prev    next >
Encoding:
Text File  |  1993-04-30  |  14.8 KB  |  383 lines
  1. PixFolio - Windows Image Viewer and Catalog Manager (Shareware)
  2.             Pre-release version 2.0 (Beta)
  3.  
  4. (c) Allen C. Kempe, 1992. All rights reserved.
  5.  
  6. Portions (c) Microsoft Corporation, 1985-1992. All rights reserved.
  7.  
  8. WARNING!!!
  9.  
  10. This version is test software and as such may contain potentially damaging
  11. bugs. The user should take the necessary precautions to insure that valued
  12. information on his or her system is protected and backed up.
  13.  
  14. The author would appreciate being notified of bugs and problems that you
  15. encounter. If you report a problem, please try to fully detail what steps you
  16. took to encounter the error. The preferred contact method is via CompuServe.
  17. My address is 71220,23.
  18.  
  19. ****************************************************************************
  20.  
  21. PixFolio is a Microsoft Windows program that can view a
  22. variety of bitmapped graphics formats and maintain multiple catalogs of
  23. images.
  24.  
  25. The graphics formats currently supported are:
  26.     BMP/DIB-Windows Bitmap
  27.     CLP -   Windows clipboard file
  28.     DRW/GRF - Micrografx draw and graph files.
  29.     EPS -   Encapsulated Postscript with imbedded TIFF preview images.
  30.     FLI/FLC - Autodesk Animator and Animator Pro (tm) files.
  31.     GIF -   CompuServe Graphics Interchange Format
  32.     ICO -   Windows Icon
  33.     IFF -   IFF/LBM (Amiga) used by Computer Eyes frame grabber.
  34.     IMG -   GEM/IMG (Digital Research).
  35.     JPG -   JPEG
  36.     MAC -   Macintosh MacPaint files.
  37.     PCX -   Microsoft Paint & PC Paintbrush
  38.     RLE -   Compuserve Run Length Encoded
  39.     TGA -   Targa
  40.     TIFF-   Tag Image Format. Most formats including 24 bit color
  41.             are supported.
  42.     WMF -   Windows Metafile.
  43.     WPG -   WordPerfect Graphics
  44.  
  45. Note: Not all variations that may be possible in the above file formats have
  46. been tested due to lack of suitable test files.
  47.  
  48. The major feature of PixFolio is the ability to build catalogs of
  49. images, that may reside on different disks. The catalog can then be searched
  50. and images can be easily located. Provisions are made for saving a primary and
  51. backup location for the image concurrently. To enhance searching for a
  52. particular image the program can display postage stamp images in a matrix.
  53.  
  54. The ability to read an image in one format and to save it in another allows
  55. the program to be used as a file conversion utility.
  56.  
  57. PixFolio version is test software under development. The author requests that
  58. copies of this version of PixFolio not be distributed to other parties without
  59. the author's permission.
  60.  
  61.  
  62. THE AUTHOR RESERVES ALL RIGHTS TO THIS PROGRAM. THE AUTHOR DOES NOT WARRANT
  63. THIS PROGRAM'S FITNESS OR SUITABILITY FOR ANY PURPOSE. ALL USERS SHOULD USE
  64. IT AT THEIR OWN RISK.
  65.  
  66. The author will make a reasonable effort to correct problems and software
  67. bugs relating to documented features of the program for registered users.
  68. The author intends to make continuing improvements to the program including
  69. supporting additional file formats. To this end, comments and suggestions are
  70. welcomed.
  71.  
  72. Users may contact the author, Allen C. Kempe on CompuServe (71220,23), on
  73. GEnie at A.KEMPE or in writing at:
  74.  
  75.         Allen C. Kempe
  76.         298 W. Audubon Drive
  77.         Shepherdsville, KY 40165-8836
  78.         USA
  79.  
  80.     The Author is a member of the Association of Shareware Professionals.
  81.  
  82.  
  83. Main Features
  84.     PixFolio utilizes Microsoft's MDI (Multiple Document Interface) so that
  85.     multiple images can be open concurrently.
  86.  
  87. File Menu:
  88.     New File - create a blank image suitable for pasting from the
  89.            clipboard.
  90.     Open File - Open a new file for viewing.
  91.     Save File - Save an image, possibly in a different format.
  92.     Move/Copy file - Move or copy a file.
  93.     Delete - Delete a file.
  94.     Print - print all or part of an image.
  95.     Select Printer - select a printer
  96.     Close
  97.  
  98. Catalog Menu:
  99.     Select catalog: Create, delete, select or rename an image catalog.
  100.     Catalog. Create or update a catalog entry for a displayed image.
  101.     Browse Catalog. View catalog entries one by one; select a subset
  102.                     for viewing.
  103.     Build Catalog. Create catalog entries for groups of images.
  104.     View thumbnails of catalog entries.
  105.     Print Catalog Entries. Two formats are provided.
  106.     Export - Export the contents of a catalog for input to a database
  107.          or spreadsheet.
  108.     Rebuild Catalog Index. Recover lost space in file and compact it.
  109.  
  110. Edit Menu:
  111.     Paste palette and image from clipboard.
  112.     Copy all or part of an image to the clipboard.
  113.     Cut a selected area from an image.
  114.     Crop an image.
  115.     Expand an image to fill the dimensions of the current window.
  116.     Resize an image by a percentage amount or fit to a given dimension.
  117.  
  118. Options:
  119.     Set background color used when image is expanded.
  120.     Set whether to use a solid or pattern background color.
  121.     Display DIB or Bitmap format.
  122.     Control whether warning messages will be displayed.
  123.     Establish default operating options.
  124.  
  125. Palette Options:
  126.     Palette manipulation (Brightness and contrast).
  127.     Convert to gray scale.
  128.     Dither to Black & White or color palette.
  129.     Play a GIF animation sequence.
  130.     Single step through a GIF animation sequence.
  131.     Change the speed of a GIF animation sequence.
  132.  
  133. Capture:
  134.     Capture the contents of another screen or the Windows desktop.
  135.  
  136. Other:
  137.     Using the mouse in the main viewing window, a marquee can be
  138.     selected for copying or cutting to the clipboard. The right mouse
  139.     button can be used to draw a stretch marquee where the selected
  140.     image rectangle is copied.
  141.  
  142. Help:
  143.     Context sensitive help is included for all menu items.
  144.  
  145. **** Other Features ****
  146.  
  147.     PixFolio version 2.0 supports OLE version 1.0 as a server only. PixFolio
  148.     will automatically register itself as an OLE server the first time that it
  149.     is executed.
  150.  
  151.     PixFolio will accept "Drag and Drop" filenames from File Manager.
  152.  
  153. ******** Equipment Requirements **********
  154.  
  155. While PixFolio will execute in a minimal Windows installation, for example, a
  156. 286 with 2 megabytes of memory, program operation will be severely inhibited
  157. by a lack of memory. On such a configuration, large bitmaps, especially 8 or
  158. 24 bit images may fail. Other applications could be adversely affected as
  159. well and fail with unexpected UAE's. Actual results will vary depending upon
  160. the amount of memory used by other applications running concurrently.
  161.  
  162. PixFolio was developed and tested on a 20-MHz 386 with 8 megabytes of memory.
  163. It is recommended that PixFolio be run on a machine with at least 4 and pre-
  164. ferrably, 6 megabytes of memory. Running in 386-Enhanced mode will also
  165. make available the benefits of virtual memory.
  166.  
  167. The display of images containing more than 16 colors requires that you have
  168. a Super VGA or better video display and a 256 color Windows device driver in
  169. order to display the full range of colors in the image. However, PixFolio
  170. incorporates dithering functions that will allow display of a 256
  171. color image using a 16 color driver such as the standard VGA driver. Such
  172. operations are slow and the results are not as good as if you have a video
  173. display capable of displaying 256 colors.
  174.  
  175. ********** Program Limitations *************
  176.  
  177. PixFolio has no limit on the number of catalogs that can be created or the
  178. size of these catalogs except those restraints imposed by your file system
  179. and te amount of available memory. However, the following points should be
  180. noted:
  181.  
  182. 1. PixFolio 2.0 will only run under Windows 3.1 or higher. Catalog file
  183.    formats are compatible with PixFolio version 1.04.
  184.  
  185. 2. The size of a catalog is limited by the amount of disk space where it
  186.    resides or 2,048 index entries. Catalog records are variable length and
  187.    depend upon the type of image and how big the comments are.
  188.  
  189. 3. PixFolio may encounter difficulty with extremely large images, those in
  190.    excess of 1024 x 768 pixels. This is particularly true of color images
  191.    and even more so by 24 bit color or gray scale images. This is primarily
  192.    due to the increased memory requirements.
  193.  
  194. 4. While PixFolio and Windows supports 24 bit color and gray scale images,
  195.    the display of such images using a video driver that only displays 256
  196.    colors, can result in some lengthy delays whenever windows has to realize
  197.    the 24 bit RGB data to an 8 bit palette. It may take 15 to 20 minutes to
  198.    realize a 640 x 480 image depending upon the speed of your machine.
  199.    Dithering a 24 bit image to 256 colors can take more than an hour in some
  200.    cases. If you plan to work with 24 bit images, you may wish to invest in
  201.    a video board that supports "high color". One such board that appears to
  202.    work quite well is the ATI VGASTEREO F/X card.
  203.  
  204. 5. The support for GIF animation in PixFolio requires large amounts of free
  205.    memory. GIF animation files with a large number of frames or overlays may
  206.    unexpectedly fail if PixFolio runs out of memory.
  207.  
  208.    Autodesk FLI/FLC animation files likewise require large amounts om memory.
  209.    To provide maximum performance, the entire image is loaded into memory to
  210.    reduce delays caused by reading from disk. A lack of physical memory that
  211.    requires Windows to utilize paged virtual memory (in 386 Enhanced mode)
  212.    can result in "jumpy" animations. In addition a high performance video
  213.    board and driver is recommended to optimally display animation files
  214.    without pauses that destroy the effect.
  215.  
  216. 6. PixFolio has not been rigorously tested in a network environment. The
  217.    affect of network operations and more than one user accessing PixFolio
  218.    files concurrently cannot be predicted.
  219.  
  220. 7. Not all graphics formats are supported equally with respect to reading and
  221.    saving a file. For example, not all of the compression options are
  222.    currently supported for saving TIFF images. GIF images can only be saved
  223.    in GIF87a format. Likewise, some of the more obscure or obsolete formats
  224.    such as 4 color CGA formats for PCX cannot be written although they can be
  225.    read.
  226.  
  227.    CCITT Group 4 TIFF file comprssion formats are not supported at this time.
  228.  
  229. 8. The author has not been able to test PixFolio with printers that print in
  230.    color in Windows 3.1 except for an Epson 2550.
  231.  
  232.    One user has reported that PixFolio give very good results printing color
  233.    images on Start Micronics NX-1000 Rainbow and NX-1020 printers but you must
  234.    obtain the OEM driver from Star Micronics.
  235.  
  236.    Printer performance when running under Windows 3.1 is much improved. It is
  237.    both faster as well as of higher quality. Changes to the printer drivers
  238.    also enable printing to color printers such as the Epson LQ-2550.
  239.  
  240. 9. The implementation of Micrografx .DRW and .GRF files is not rigorous. Some
  241.    features of these files are not supported. Unless you have Adobe Type
  242.    Manager or scalable typefaces, the rendition of fonts used in these files
  243.    may not be optimal when Windows matches fonts.
  244.  
  245. 10. Other program limitations, if any, can be determined by accessing the
  246.    online context-sensitive help.
  247.  
  248.  
  249. ****** Installation and Getting Started*******
  250.  
  251. If your copy of PixFolio was received on a distribution diskette, the
  252. installation should be done from within windows by running "SETUP" from drive
  253. A: or B: (whichever is appropriate). This is important as the files on a
  254. distribution diskette are compressed. Otherwise, the following installation
  255. procedure should be followed:
  256.  
  257. It is suggested that the files which constitute PixFolio be placed in their
  258. own subdirectory on your hard disk. These files are:
  259.  
  260.     PIXFOLIO.EXE
  261.     PIXFOLIO.HLP
  262.     SPIN.DLL
  263.     METER.DLL
  264.     PIXDLL.DLL
  265.     PIXIODLL.DLL
  266.     PIXHELP.DLL
  267.     PIXCATLG.DLL
  268.     PIXTIFF.DLL
  269.     PIXGIF.DLL
  270.     PIXFLIC.DLL
  271.     PIXWPG.DLL
  272.     PIXJPEG.DLL
  273.     PIXCNTRL.DLL
  274.  
  275.     The following files are Microsoft supplied DLL's that are necessary to
  276.     provide dialog services and other functionality. Note if you have Windows 3.1,
  277.     you should already have these files.
  278.  
  279.     COMMDLG.DLL
  280.     OLESVR.DLL
  281.     SHELL.DLL
  282.  
  283.  
  284. Once the above files have been located in the subdirectory of your choice,
  285. start Windows and then use the Program Manager "Add" command to add PixFolio
  286. to the desired program group.
  287.  
  288. When PixFolio runs for the first time, it will establish a section in
  289. your WIN.INI file with program variables. These default options should enable
  290. you to start using PixFolio immediately. Once PixFolio is running you may
  291. access the online Help command for specific instructions and explanation of
  292. PixFolio menu commands.
  293.  
  294. A quick review of PixFolio features and operating procedures can be gained by
  295. reviewing the user guide.
  296.  
  297. ****** Credits ******
  298.  
  299. The author of PixFolio would like to recognize the efforts of Mr. Paul Hachey,
  300. (CompuServe Id 76625,2644) who performed an invaluable service by getting
  301. deeply involved in the extensive testing that went on over a period of months.
  302. Paul is responsible for the design of the PixFolio cover page, Icon and
  303. "About" dialog box and his many suggestions greatly influenced the "look and
  304. feel" of PixFolio.
  305.  
  306. Other people who have participated in the testing of PixFolio include:
  307.  
  308.     Luis Alvarez
  309.     David Brune
  310.     Monte Davis
  311.     Sean Gonzales
  312.     James Horner
  313.     Tom Little
  314.     John Sabo
  315.  
  316. Their help is appreciated.
  317.  
  318.  
  319. Recent Changes:
  320. ***** Version 2.0.27 *****
  321.  
  322. 200. Correct problem with setting default tile type in File Save As.
  323.  
  324. 201. Insure that default file save options are set properly before a File
  325.      Save is executed.
  326.  
  327. 202. Eliminate error message "Cannot Render Bitmap" that occurs when copying
  328.      to the clipboard and the DIB to Screen option is turned on.
  329.  
  330. 203. Insure that cancelling a read DRW file will terminate clean without
  331.      extraneous errors or UAE's.
  332.  
  333. 204. Correct error that prevented creating a catalog on a removable drive
  334.      that was overridden with a "Primary Drive" parameter.
  335.  
  336. 205. Correct a crash that occurs when clicking on a thumbnail's title in
  337.      Alpha sequence.
  338.  
  339. 206. Added file size, date & time to Tech Info.
  340.  
  341. 207. Added help to error and warning messages associated with creating a new
  342.      catalog.
  343.  
  344. 208. Insure that thumbnail view gets re-drawn after a Catalog Build operation.
  345.  
  346. 209. Dropping a file on Pix now works.
  347.  
  348. ***** Version 2.0.28 *****
  349.  
  350. 210. Got JPEG version 3 working.
  351.  
  352. 211. Fix favorite directory commands so that they set the DOS current drive.
  353.  
  354. 212. Correct TIFF and TGA write routines to pass the correct file name. Also,
  355.      correct error message if write fails to "Error writing file".
  356.  
  357. 213. Allow Cancel button on Build dialog to be used while a Build is going
  358.      on to cancel the Build.
  359.  
  360. 214. Check "Stop on Error" and if not on, proceed after an error during a
  361.      build operation.
  362.  
  363. 215. Correct creation of thumbnails for 2 color images so that the colors
  364.      aren't reversed.
  365.  
  366. 216. Display the same list of supported file types that appears for file
  367.      open for the Build dialog.
  368.  
  369. 217. Add necessary logic to read Group 3 FAX files.
  370.  
  371.  
  372. 218. Add support for CompuServe RLE files.
  373.  
  374. ***** Version 2.0.29 *****
  375.  
  376. 219. Eliminate possibility of causing a GPF if user presses the "Update"
  377.      button while the thumbnail bitmap is being created.
  378.  
  379. 220. Eliminated bogus error "file already exists at ...." when re-cataloging
  380.      an image.
  381.  
  382.  
  383.